home *** CD-ROM | disk | FTP | other *** search
/ TeX 1995 July / TeX CD-ROM July 1995 (Disc 1)(Walnut Creek)(1995).ISO / macros / musictex / software / abc2mtex / README < prev   
Text File  |  1995-01-24  |  4KB  |  106 lines
  1.  
  2. Welcome to abc2mtex Version 1.3
  3.  
  4. abc2mtex contains the following files:-
  5.  
  6. README        -- this file
  7. Changes        -- changes between this version and version 1.0
  8. usrguide.tex    -- userguide in LaTeX
  9. index.tex    -- guide to indexing in LaTeX
  10. Makefile    -- makefile
  11. abc.c        -- C code to format abc notation
  12. fields.c    -- C code to format other tune information
  13. tex.c        -- C code to output MusicTeX
  14. index.c        -- C code to index your tune database
  15. sort_in.c    -- C code to sort the index
  16. search.c    -- C code to search your tune database
  17. index.h        -- C code header for indexing
  18. index.fmt    -- example index format file
  19. header.tex    -- a header file for the MusicTeX output
  20. header1.tex    -- a new header file with a customised format
  21. Xenglish.abc    }
  22. Xjigs.abc    } -- example tune files.
  23. Xreels.abc    }
  24. Xstrspys.abc    }
  25.  
  26. Additional related files you may find at an ftp site (e.g. celtic.stanford.edu
  27. in /pub/tunes/abc2mtex) are:
  28. abc2mtex1.3.tar.gz    -- the whole package tarred and gzipped for UNIX users
  29. INTRO.txt        -- an ascii introduction to abc
  30. INTRO.html        -- a hypertext introduction to abc
  31.     (e.g. URL http://celtic.stanford.edu/pub/tunes/abc2mtex/INTRO.html)
  32. PaddyORafferty.gif    -- example tune inlined into INTRO.html
  33. abc.txt            -- the rules of abc notation in ascii
  34.                 (a cut down version of the usrguide)
  35. usrguide.ps        -- a compiled PostScript version of the usrguide
  36. abc2mtex.exe        }
  37. search.exe        } -- executables compiled for PCs
  38. sort_in.exe        }
  39.  
  40.     The package was originally written for UNIX machines and is probably
  41. easiest to use on them. All such machines should have a C compiler and are
  42. likely, especially in educational establishments, to have TeX/LaTeX already
  43. installed (if not, it can be obtained by anonymous ftp from ftp.wustl.edu in
  44. packages/TeX). MusicTeX, the only other requirement, can be obtained from
  45. various ftp sites such as celtic.stanford.edu in /pub/tunes/Music.TeX,
  46. ftp.wustl.edu in /packages/TeX/macros/musictex or
  47. ftp.gmd.de in /music/musictex.
  48.  
  49. If you have a UNIX machine you then only need the file abc2mtex1.3.tar.gz.
  50. Download it then type:
  51.  
  52. zcat abc2mtex1.3.tar.gz | tar xvf -
  53.  
  54. To read the usrguide you need the MusicTeX macro packages musicpre.tex
  55. musictex.tex, musicnft.tex, musictrp.tex, musicvbm.tex, musicpos.tex and
  56. musictex.sty.  Make sure that they are available to TeX as input files
  57. (either put them in this directory or use the environment variable TEXINPUTS).
  58. Then "latex usrguide.tex" twice. Everything else is explained there (except
  59. indexing which is described in "index.tex" - "latex index.tex").
  60. Alternatively, the Ceolas ftp site (celtic.stanford.edu in pub/tunes/abc2mtex)
  61. contains a ready compiled postscript version, usrguide.ps.
  62.  
  63.     For PC users, I have compiled the code using a Turbo C 2.0 compiler.
  64. The three PC executable files are abc2mtex.exe, sort_in.exe & search.exe
  65. which should be available at the Ceolas ftp site. Most things should work as
  66. described in the documentation, although you will not be able to use the
  67. 'make' command and I believe that DOS will not interpret *.abc as "all files
  68. with a .abc extension" when it is used as as command line input to the
  69. program. To get hold of TeX, the package emTeX for PCs can be obtained from
  70. the TeX Users Group, P.O. Box 869, Santa Barbara, CA 93102, USA. (email
  71. TUG@TUG.org) and MusicTeX from the same ftp sites as above. Alternatively,
  72. Alan Ng has stripped everything you need from TeX and MusicTeX and put them
  73. in one package, tex2dvi.zip, available by anonymous ftp (celtic.stanford.edu
  74. in pub/tunes/tex2dvi.zip).
  75.  
  76.     Mac users will have to get hold of a C compiler (though if you have
  77. one and can compile the executables it would be nice if you could submit the
  78. executable to the ftp site you got the package from). To get hold of TeX,
  79. the package OzTeX (for Macs) can be obtained from the TeX Users Group,
  80. address above.
  81.  
  82. playabc:
  83.     A program written by Don Ward to play tunes (which are written in the
  84. abc format) on the built in speaker of a Sparc workstation is available by
  85. anonymous ftp from celtic.stanford.edu in /pub/tunes/playabc-1.0.tar.Z .
  86. It also plays sounds on NeXT, PC-Un*x, Silicon Graphics, modern X terminals ...
  87. basically on any sound-capable system where yacc/lex are available.
  88.  
  89.  
  90. Compatibility:
  91.     The following version numbers are (I believe) fully compatible
  92. Other version combinations should be mostly compatible.
  93.  
  94.      abc2mtex  playabc    musictex
  95.     1.0    1.0         -> 4.98
  96.     1.1    1.0         -> 4.98
  97.     1.2    1.1     4.98 -> 5.04
  98.     1.3    1.1     4.98 -> 5.06
  99.  
  100. Have fun,
  101.  
  102. Chris Walshaw
  103.  
  104. C.Walshaw@gre.ac.uk
  105.  
  106.